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HOW TO USE THIS MANUAL 

This manual is in four parts. Part One is a general 
description of the Atari Music Composer program. Part Two 
is a step-by-step tutorial on how to use the cartridge. 

The best wav to use this manual is* first* read all the 
wav through Part One. This will give you a general idea of 
what the cartridge is about. Don't worry too much about the 
specific details. That will come later. 

After you have read Part One* follow the instructions in 
Part Two. It will take you through a sample session* and 
show you exact 1 y how to use the Cartridge. From time to 
time* you will want to refer back to Part One for more 
detail. And* eventually* you should read completely through 
Part One at least one more time. 

For advanced users* Part Three describes the music file 
storage format* and how to manipulate the files with 
external BASIC programs. Example BASIC programs to generate 
notes and to write harmony lines for a given melody are 
i nc 1 uded . 

Part Four of this manual is a brief listing of each of 
the commands* and of each of the file formats. This section 
is intended as a guick look— up reference after you are 
familiar with the commands. 
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PART ONE 


GENERAL DESCRIPTION OF THE ATARI MUSIC COMPOSER 


A 
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WHAT DOES IT DO? 

The Atari Music Composer Cartridge will enable you to 
enter music for up to ten sections into the computer. You 
can then listen to vour music while you see it displayed on 
the video screen. You can change anr note of a nr measure of 
the music you have written. The computer will correctly 
accept music written in anY key. If you like? it will check 
for the proper number of beats per measure for different 
meters . 

You can quickly and easily change the tempo of rour 


music. After you have entered rour music into the computer? 
you can arrange the music to plar the different sections in 
the order you choose. Up to four lines can pUy at once. 
Music can be transposed? and it can be played at different 
volumes. You can display anr single line of music on the 
video screen while the music is playing. Or? you can 
display a line of music that does NOT plar? while you plar 
another instrument along with the computer. 

Once you have entered rour music into the computer 
memory? you can save all or part of it on cassette or disk. 


Since the music is stored as a list of numbers on the 


cassette or disk? you can also write BASIC programs that 
will change the music you have written. For example? you 
can convert a melody line into melody plus harmony. You can 


even write BASIC programs to "compose" music br rules you 


devise 
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THE MAIN MENU 

The Atari Music Composer Cartridge is a computer program 
that is arranged as a group o t menus. When first started* 
the computer- displays the Main Menu of six selections. 

These selections are! 

Edit music 
Arrange music 
Save 

Re tr ieve 
DOS 

Listen 


Some of these selections will display a menu of t heir- 
own. One of the commands will always be "Stop" or " S " * 
which will return you to the Main Menu. Some of the 
s u b— me n u c omman ds will allow a third 1 eve 1 o f c omman d s . 
These commands also have a "Stop" or "S" command that 
returns you to the sub-menu. Another "Stop" command will 
call up and display the Main Menu. 

This hierarchy of menus is at once very powerful and 


very straightforward to use. You don't need to memorize all 
the many commands available. You simply deal with the 
commands for your current section or sub-section of the 

s' 

program. 


To select a menu item* simply type the first letter of 
the item and then type the return key (which we will refer 
to as "Oet>" ). For example* to select Edit music* type 


"ECr-e t>" 
<ret> 


You can actually type it all out — "Edit music 


ii 


if you like 


The computer Just looks at the first 
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letter you tvpe arid it ignores the rest. 

You can "erase” letters bv pressing the BACK SPACE kev 
once for each letter you want to delete. 

After you have tYPed Your command? be sure to tvpe the 
<re t> keY. That's the computer's signal to act upon what 
you have tvped in the command line? and it won't do ariYthins 
until it gets that <Iret>. 
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EDIT MUSIC 

Typing ,, E<ret>" from the main menu? to Edit music? 
immediately causes another menu to be displayed. This is 
actually a combination of menu and status. The menu 
selections appear on the left with their status values to 
the right. The display looks like this: 


EDIT MUSIC 


Phrase 


Meter- 

4/4 

Key sig. 

OS 

Tempo 

2 

Che c k meas u res 

OFF 

WHICH? 



These commands allow you to change music that has 
already been entered into the computer memory. Or they 
allow you to more easily enter unusual musical formats. 
Change PHRASE allows you to enter new music? or to edit 
notes already in memory. Change METER and CHECK MEASURES 
help you keep track of the durations in a measure of music. 
KEY SIG. allowes you to change music already entered to 
display in any key? or to enter music that was written in a 
key other than C. TEMPO changes the speed at which the 
music is played by the computer. And STOP returns you to 


the Main Menu 
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CHANGE PHRASE 

This command allows you to enter your music into the 
computer memory? or to edit notes al ready in memory. 


When you type "P Oet>" for change Phrase? the computer- 
will ask "Phrase #?" . There are ten phrase numbers? O to 9 
These allow you to label the different musical sections so 
you can manipulate them later with the "Arrange" command. 
You must type one of the disets? 0-9? and < ret > . 

Next? the computer will ask “ERASE?". If you wish to 
erase al 1 previous measures in the phrase? as when you are 


entering new music? type " YOe t>" . Type "N<ret>"? or Just 


"<ret>" if you DO NOT wish to clear the phrase. 

If you do not erase the phrase? the computer will ask 
"MEASURE #*?"? so you can edit any previously entered 
measure. You would type the measure number and <Iret>. If 
you do erase? the computer puts you directly in Measure #1? 
after it has cleared the phrase. 

Next? the computer displays two music staves. These are 
the standard piano staves? with the trebel clef on the top 
staff and the bass cleff on the bottom staff. Each octave 
ranse is indicated by a different background color. Unless 
previously changed? he key will be C (no sharps or flats)? 
and the meter will be 4/4. The dark vertical bar positioned 
Just after the time signature is the cursor. This is where 
the next note you write will be entered. As you enter 
notes? the measure will be played? and the cursor will move 
to the right. 

Three numbers are under the music staves. They tell you 
which phrase you are in (PHRASE ###)? which measure of that 
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phrase (MEASURE ###)* and the remaining free memory space? 
expressed in notes that can be stored (#### FREE). 


On the last line of the screen is the prompt 


"SMI* NOTE?". This is a sort of menu? all scrunched down to 
one line. It means! 

Stop 

Measure # 

Insert measure 
enter next NOTE 

So? if you want to return to the Edit Music menu? you 
tvpe "S<ret>" . To go to the next measure or to a n y other- 
previous! y entered measure? type "M#<ret>"? onl y instead of 
tYPins "#" ? type the actual measure number? as "M12<re t>" . 

If you want to insert a new measure somewhere in Your 
music? say between measures 2 and 3? first tYPe "M3<Ire t>" . 
Measure 3 will be displayed and will play. Next? type 
"I<ret>" . This will "push" all measures from measure 3 
(where you are) to the last measure in that phrase? up one 
measure. What was measure 3 is now measure 4? what was 
measure 4 is now measure 5? and so on. Measures 1 and 2? 
below the Insert command? are not changed. Only measures 
above the Insert are moved. And the new measure 3 is empty? 
ready for you to put notes into it. 


HOW TO ENTER NOTES 


To enter a note you must give the computer several 
pieces of i n f o r ma t i o n . First? you must tell it the letter- 
name of vour notes C? D> E? F? G> A? B? or R (rest). You 
may indicate a sharp or a flat or a natural by following the 
letter name with “S'* or “F" or "N". An accidental will 
change all of the same notes following? until the end of the 
measure? or until another accidental for the same note. 

Next? you tell the computer which octave the note is in. 
This is a number between 3 and 6. Octave 3 starts with the 
C below middle C. Octave 4 starts with middle C. Octave 5 
starts with the C above middle G. And Octave 6 starts and 
ends with the C above that? “high C“. 

You onlY need to enter the Octave Number to change 
octaves. If you do not enter an Octave Number? the computer- 
uses the last one it was given. 


(music example here) 

Middle C Octave 3 Octave 4 Octave 5 Octave 6 

Durations go from whole notes to th i r tY— second notes! 

W = = Whole note 

H = = Hal f note 

Q = = Quarter note 

E = = Eighth note 

S = = Sixteenth note 

T = = Thirty— second note 

Note values may be followed by a dot? “ . “ ? to make them 
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1/2 longer than normal. If you wish to tie the note to the 
one that will follow* type "T". This appears as a tie 
( ) on the screen* and it will cause the note to continue 

to sound until the next note is started. Normally* without 
the tie* there is a small space of silence between each 
n o t e . 

Some examp 1 e s s 

(music examples 1 to 5 here) 

(1) Low C* a sixteenth note. 

Type 5 C3S<re t> 

(2) Middle C* a dotted eighth note. 

Types C4EOet> 

(3) E above middle C* a quarter note tied to — 

D# above middle C * a dotted eighth note tied to — 

C above middle C* an eighth note 
Type s E4QT<Ire t> 

DSE. TOe t> 

C5E<ret> 

(4) An Eighth rest 
Types RE<ret> 

(5) Bb above middle C* a half note. 

Types BF4H<ret> 

To sum up* the format for entering a note iss 
LETTER (ACCIDENTAL) OCTAVE DURATION (DOT) (TIE) 

Accidental* Dot and Tie are options and may be left out. 
If Octave is not entered* the computer uses the last Octave 
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Number it was given. Letter and Duration are not optional 
and must be included. 

The format for entering a rest is* 

R DURATION (DOT) 

Dot is an option that? as for note durations? will cause 

the rest to be half again as long. "R" (for Rest) and 
Duration must be included. 


* 
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CURSOR CONTROL KEYS 


The cursor control keys allow you to insert new notes 
between existing notes? or to delete notes. The keys are: 
CTRL < — move cursor left 

CTRL — > move cursor right 

CTRL DELETE delete one note 


CTRL CLEAR delete all notes in this measure 

The CTRL key must be held down while depressing the 
cursor control keys. New notes will always be inserted Just 
before the cursor. Therefore? to insert a note between 
existing notes? use the CTRL < — or CTRL — > to position the 
cursor Just after where you want the new note to be 
inserted. Then enter the note in the normal way. 

CTRL DELETE will always delete the note that is within 
the dark cursor area. To delete a note? use CTRL < — or 
CTRL — > to position the cursor exactly on the note you wish 
to delete. Press CTRL DELETE? and the note is gone. 

CTRL CLEAR will always delete all notes in the measure? 
regardless of where the cursor is. Press CTRL CLEAR and the 
measure will be empty of notes. 
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CHANGE METER /CHECK MEASURES 


Since the computer dosen't have to keep time with 
anybody but itself? it really doserr’t care what meter you 
use. You can make any measure contain any number of notes. 
It won't get confused and miss beats? as a human performer 
likely would. But if you wish to stay within a particular- 
meter? you can have the computer perform a measure check 
while you are enter i ns notes under the “Edit Music** command 
While in the “Edit music" menu? typing "C<ret>" ? for 
"Check meter"? will cause the status word to change from 
"OFF" to "ON"? or from "ON" to "OFF". If the Check meter- 
status is "OFF"? then it will have no effect? nor will 


"Meter " 


If Check meter is "ON"? then while you are 


entering notes the computer will not allow you to leave your 
current measure until the number of beats is correct. It 
will say "Measure too short" or "Measure too long". The 
exception is? on the first and last measure? you may have 
fewer than a full measure of beats. 

The command "MOe t>" for change Meter allows you to set 
the number of notes per measure. 4/4 sets four quarter 
notes per measure. The computer will allow any combination 
of notes or rests that is equivalent to four quarter notes 
per measure. One whole note? for example. Or two eighth 
notes? one quarter note? and one half rest. A meter of 2/4 
will allow the equivalent of 2 quarter notes per measure. 
That could be one half note. Or one quarter note and one 
quarter rest. Or sixteen thirty-second notes. 

Once your music has been entered into the computer- 


memory? the Change Tempo/Check Measures commands has no 
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further effect- These commands are only 



enter music into memory correctly. They 


the computer plays the music. 


an aid to help you 
do not affect houi 
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CHANGE KEY 

Key signatures are normal 1 y written as a number of 
sharps (#) or flats (b) on the staves between the clef and 
the time signature. For example: 


(music examples here) 


Key of D Major 
Key of B minor 


Key or G Major 
Key of E minor 


Key of Eb Major 
Key of G minor 


The Change Key command allows you to enter music in the 
key in which it was written? even if you aren't sure what 
the key is. Before entering vour music? simply count the 
number of sharps or flats in the Key signature. Then? from 
the "Edit Music" menu? type "KOet>" . The computer will 
respond with "New Key Sig.?". You type the number of sharps 
or flats? and then "S" if they were sharps or "F" if they 
were flats? and <ret>. In the above three examples you 
would type "2S<ret>" for the first? "18<ret>" for the 
second? and " "2FOe t>" for the third. The computer will 
accept and display music in the proper key. 

Changing the key signature AFTER music has been entered 
in memory will cause it to be displayed in the new key. 


However? it will play in the original key. 


CHANGE TEMPO 


You can have the computer play your music faster or 
slower with the Change Tempo command. There are 9 tempos* 
numbered from 1 to 9. A tempo of 1 is fastest* a tempo of 9 
is slowest. You can change tempo any time you wish* before 
or after entering music. From the "Edit Music" menu* type 
"T<ret>". The computer will respond with "New tempo?". 

Type the tempo you want* 1 to 9* and <ret>. The new tempo 
will be entered and you will see it as a status number after 
the word "Tempo" in the menu. 
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ARRANGE MUSIC 

After music has been entered into the computer memory? 
you can arrange how the computer is to play it. There are 
four voices? or sound channels? numbered 1 to 4. Each voice 
plays independently of the other three. This allows you to 
arrange? or program? each voice differently. 

When you type “A<ret>“ from the Main Menu? you are 
telling the computer you want to Arrange music. The 
computer will respond with “Voice #?". You tell it which 
voice you want to arrange by typing the number? and <ret>. 
For example? " l<ret>" . If this is the first time you have 
given the “Arrange music “ command? the Aranse Menu will be 
d i s p 1 aye d • 

ARRANGE MENU 

Count 
D i s p 1 ay 
Goto 1 ine 
M for this menu 
Play phrase 
Stop 

Transpose 
Vo 1 ume 

SPACE BAR TO GO ON 

If you press the space bar (or any other key)? the menu 
will be replaced by the Arrange Voice program. This is a 
list of 20 numbered lines* and on the bottom line is the 


unpr onouncab 1 e magic word “CDGMPSTV“ 
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The numbered lines are the 20 program steps available to 
each voice. And the magic word is the first letter from the 
Arrange music menu selections. To display the menu again* 
type "M<ret>" . Type the space bar* and you are back again 
with the 20 program steps. 

After the first time you call "Arrange music" from the 
Main Menu* the Arrange menu will NOT be displayed. Instead* 
you will immediately get the 20 program steps for the voice 
you asked for. If you want to see the Arrange menu* Just 
type "M<ret>". 

When you are ready to return to the Main Menu* type 
"S<ret>" * for "Stop". 

All the other commands in the Arrange menu are actually 
programming steps. They are not done when you type them in. 
Instead* they are entered as one of the 20 program steps. 

The computer will do all the steps you have programmed when 
you give it the "Listen" command from the Main Menu. 
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DISPLAY 

E* i s p 1 a v tells the computer to display the notes of that 
voice as they are beins played. While all four voices can 
play at once? only one voice can be displayed at a time. 

The Display instruction selects which of the four voices 
is to be displayed on the video screen. That voice will 
continue to be displayed until another voice finds a Display 
instruction. If two or more voices have the Display 
instruction at the same time? the lowest numbered voice will 
be displayed. To enter the Display command? type ,, D<ret> u . 
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PLAY 

Plav tells the computer to play a phrase. To enter the 
Play instruction? type ,, P<ret> 11 . The computer will ask 
“Phrase #?**. Enter the number of the phrase you want it to 
plav at that step? and <ret>. Any phrase? 0 to 9? may be 

entered at any of the 20 Arr arise program steps? in any of 

' 

the four voices. 

The Plav instruction is the only instruction that has 
duration. Duration is the time the computer takes to plav 
the phrase. All the other instructions have no duration. 
This means that in order to make phrases in different voices 
play together? you only count the play instructions. Don't 
count the other instructions. 

For example? suppose you have four phrases of music. 

The meter? or beats per measure? is the same for all. 

Phrase #1? phrase #2? and Phrase #3 have four measures each? 
so they have the same duration. Phrase #4 has eight 
measures? so its duration is twice that of the other- 
phrases — because eight measures take twice as long to plav 
as four measures. Now? suppose your Arrange program looked 
like this! 

Voice #1 

1 D i s p 1 a y 

2 Plav phrase 1 

3 Plav phrase 2 

4 

Since only the Play instruction has duration? voice #1 
will Display and Plav phrase 1 while voice #2 plays phrase 2 
and voice #3 plays the first half of phrase 4. Then voice 


Voice #2 

1 Plav Phrase 2 

2 Display 

3 Plav phrase 3 

4 


Voice #3 

1 Play Phrase 4 

2 

3 

4 
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#1 mill p 1 av phrase 2 mhile voice #2 Displays and Plavs 
phrase 3 and voice #3 continues to play phrase 4. Then? 
since there are no more instructions? all the voices mill 
stop. 

To keep all this straight? you really only need to 
remember one rules The Play instruction is the ONLY 
instruction that has duration. So? mhen you are dec i dins 
mhen each voice plays a phrase? only count the Play 
instructions. Don't count the other instructions. 
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VOLUME 

Volume tells the computer how loudly you want phrases 
plaved. For each voice? the Volume instruction will affect 
all further Play instructions in that voice. The loudness 
won't change again unless the computer gets another Volume 
instruction for the same voice. 

To enter the Volume instruction? type "V<ret>" . The 
computer will respond with "Volume?" . Volumes are O (zero) 
for off? and the six standard loudness abbreviations? pp? p? 
mp? mf? f? and ff. The softest sound is pp? and the loudest 
is ff. You would give the computer one of these? and <ret>. 

If you don't use the Volume instruction? the computer 
will play all phrases at half loudness? Volume mf. 

As an example? suppose you have two phrases of music. 

You want the computer to play phrase 1? but you want to play 
phrase 2 on your flute. You want the computer to display 
phrase 2? but not to play it. Your Arrange program would 
look like this: 


Voice 1 

1 Play phrase 1 

2 
3 


Voice 2 

1 D i s p 1 ay 

2 Volume 0 

3 Play phrase 2 


4 4 

Now? Phrase 1 will play at half loudness while phrase 2 
is displayed on the video screen? but is not played. And 
your friends can see the notes you play as you you "Jam" 


with your computer 
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TRANSPOSE 

Music is transposed when it is played at a higher or 
lower pitch than it was written. The Transpose instruction 
will do this for each voice. You can play a phrase of music 
unchanged in one voice* and p 1 ay the same phrase transposed 
in another voice. 

For each voice 7 the Transpose instruction will affect 
all futhur phrases in that voice until the computer finds 
another transpose instruction in the same voice. To enter 
the Transpose instruction* type M T<ret>". The computer will 
respond with "# 1/2 steps?". It will accept any number from 
—36 to 36. Positive numbers* numbers without the minus 
sign* transpose up. They make the music sound higher in 
pitch. Minus numbers transpose down. Thev make the music 

' v 

sound lower in pitch. 

Each 1/2 step is eguivalant to the pitch change from a 
note that is played natural* to the same note played sharp. 
Say* D2 to D#2. Each minus 1/2 step — each 1/2 step down — 
is equivalant to the pitch change from a note that is played 
natural* to the same note played flat. Say* D2 to Db2. 

As an example* suppose you want to play phrase 1 as it 
was written* then play it transposed up one octave (12 1/2 
steps)* then play it again as it was written. Your Arrange 
program would look like thiss 
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1 Display 

2 P 1 av phrase 1 

3 Transpose 12 

4 Plav phrase 1 

5 Transpose -12 

6 Play phrase 1 

7 

Step number 5* Transpose -12* takes the voice back to 
its orisional pitch (12-12=0). It is fairly easy to 
instruct the computer to transpose music out of the 
computer's three octave playing range. When this happens* 
the computer will do the best it can* but the results can be 
surpr i s i ng . 


# 


GOTO /COUNT 


These two instructions control the flow o f y o u r arrange 
program. Normally? the computer will do each instruction in 
order? from step 1 to the last step of the program. The 
Goto instruction changes that. 

When the computer finds a Goto instruction it goes to 
the line number in that instruction. For example? suppose 
you want to play phrase 1? 2? and 3? then you want to play 
phrase 2 and 3 over and over. Your Arrange program would 
look like this* 

1 Display 

2 Play phrase 1 

3 Play phrase 2 

4 Play phrase 3 

5 Goto 3 

The computer will do each instruction in order until it 
gets to line #5? which tells it to go to line #3. It goes 
to line #3 and does each insturction in order until it gets 
to line #5? which tells it to go to line #3. And so on. 

And so on. 

This is called a loop because it loops from line #5 to 
line #3. And? because it never stops looping (unless you 
turn the computer off? or hit the SYSTEM RESET key)? it is 
called an infinite loop. 

To enter the Goto instruction? type ,, G<ret>" . The 
computer will respond with "Line #?". Type the line number 
you want it to Goto? and < ret > . The line numbers must be 
between 1 and 20. If you should instruct the computer to 
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Goto a line number that does not contain an instruction* it 
could become confused when it tries to run your Arrange 
program. So be sure to always Goto a line that has an 
instructi o n . 

While the infinite loop Goto instruction is fine for 
plaving the same thins over and over* it's not good for much 
else. Suppose you want to play phrase 1 three times* then 
play phrase 2 twelve times* each time transposed by one 1/2 
step* then play phrase 1 again. To do something like this* 
the Goto instruction has to be "smarter" . And it is. 

This is where you need the Count instruction. The Count 
instruction will tell the Goto instruction how many times it 
should loop before going on to the next program line. An 
Arrange program to do the example above would look like 
this: 

1 Display 

2 Count 3 

3 Play phrase 1 

4 G o t o 3 

5 C o unt 1 2 

6 Transpose 1 

7 Play phrase 2 

S G o t o 6 

9 Transpose -12 

10 Play phrase 1 

11 

Line 2 sets the Count to 3* so line 4 will loop back to 
line 3* three times. Then it goes on to line 5. Line 5 


sets the Count to 12* 


so line 8 loops back to line 6 twelve 
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times. Each time through the first loop? the computer plays 
phrase 1. It plays three times. Each time through the 
second loop? the computer Transposes one 1/2 step and plays 
phrase 2. After the twelveth loop* it Transposes back down 
to where it was at the start* and plays phrase 1 a final 
t i me . 

To enter the Count instruction* type "COe t>" . The 
computer will ask "Count #?". Type the number of times you 
want the next Goto instruction to loop* and <ret>. You can 
loop as many as 127 times. If you want to loop always (the 
infinite loop)* enter a Count of -1. 

If you do not use the Count instruction in your Arrange 
program* but you do use a Goto instruction* the Goto will 
assume a count of -1* and it will be an infinite loop. 
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EDIT KEYS 

When first powered up* voice #1 will already have 2 
program steps 5 

1 Display 

2 Play phrase 1 

* 

O 

These* or any other previously entered program steps can 
be changed (edited) by using the Edit Keys. Notice that one 
line number — line number 3 in the example — is darker than 
the other line numbers. It should be blue on a color TV. 
This is the current line cursor and it is where the next 
program step will be entered. 

The four Edit Keys allow you to change the position of 
the current line cursor or to change what is in the current 
line. The Edit Keys ares 
CTRL (up— arrow) move current line cursor up 

CTRL (down— arrow) move current line cursor down 

CTRL DELETE delete instruction at current line 

CTRL INSERT insert instruction at current line 

Whenever you type in an instruction it will be put into 
the line number that is shaded by the current line cursor. 

For example* if the cursor is on line number 3* and you want 
to change the instruction at line number 1* you use CTRL 
(up— arrow) to move up two lines. Hold CTRL down* then type 
(up-arrow) twice. Line 1 will now have the dark color. Any 
program step you enter will now go in this line. Anything 
already there will be replaced when you enter the new 
instructi o n . 

If you want to delete what is on the current line and 


not enter anything in its place? type CTRL DELETE. 


This 


erases what was on the current line* and moves everything up 
one line to close up the gap. CTRL INSERT has the opposite 
effect. It will move everything down one line* including 
what was previously there. The current line will be empty* 
ready for you to insert a program step. 


Page 


LISTEN 


The Listen command tells the computer to run the Arrange 
program. A short Arrange program is automatically entered 
into the computer memory when it first starts the Music 
cartridge. If you have not entered your ouin arrange 
program* then this default program will run. 


Voice 1 

Voice 2 

Voice 3 

Voice 4 

1 Display 

1 Play phrase 2 

3 Plav phrase 3 

4 Play Phrase 

2 Play phrase 1 

2 

2 

2 

3 

3 

o 

3 


This program plays phrases 1 to four simul taniousl v 
through voices 1 to 4. Also* it displays voice 1. If any 
of these phrases are not in the computer's memory* it 
ignores that play instruction. This all owes you immediately 
to Listen to music you have entered in any of the four 
phrases* without stopping to write an Arrange program. 

To "Listen'* to your music* type "L<ret>" * from the Main 
Menu. The computer will display the two staves* and it will 
play your music according to the Arrange program — either 
the default program* or one you’ve entered. Then it will 
return to the Main Menu. 


SAVE/RETRIEVE 


These co mma nds 0 . 1 1 o w v ou t o yave and Retrieve y o u r m u s i 
to and from external storage? usually cassette or disk. 

11 Save M sends the rriusic data from the computer rrierriorv out to 
external storage. And "Retrieve" gets the data from 
external storage and puts it into the computer's memory. 
Except for this difference in the direction of the data 
flow? the two commands are alike. 

When in the Main Menu * and you type "SO e t> " or "R<ret> 
for "Save" or "Retrieve"? the computer will respond with* 

RAVE (or RETRIEVE) MUSIC 

E Everything 
AP A1 1 Phrases 
AV A1 1 Voices 
Px Phrase x 
Vx Voice x 
Si S t o p 

FN? 


Before you go any further* you must respond to the 
computer's "FN?" prompt? which stands for "File Name’?". 

The response to this? if you have a cassette? is 
"Cs Oe t>" . If you have a disk drive? use standard Atari 

disk file names? as "Ds MYMUSIC. V3" . Refer to your Computer- 
manual? your Basic manual or your Disk Operating System 
manual for more detail on cassette or disk operation. 

After you have correctly entered the File Name of your 


music data? the computer will ask "Which?". Type "E<ret>" 


to Save or Retrieve "Everything 11 


all music (Phrases) and 


all Arrange programs (Voices). 

If you only want to Save or Retrieve the music and not 
the Arrange programs? type "AP<ret>"? for "All Phrases". 

And if you only want one of the 10 Phrases? type "Px<ret>". 
Only? instead of typing the "x"? type one of the 10 Phrase 
numbers? 0 to 9 ? as "P2<ret>" . 

If you only want to Save or Retrieve the Arrange 
programs and not the music? type "AV<ret>"? for "All 
Voices". And if you only want one of the 4 Voices? type 
"Vx<ret>" • Instead of typing the "x"? type one of the 4 


Voice numbers? 1 to 4? as "VKret>". 

The computer will ignore commands to Save Phrases or 
Voices that do not exist in its memory. And it won / t 
Retrieve a phrase or voice that had not previously been 
saved. So? if you Save "All Phrases"? and then try to 
Retrieve "Everything"? the computer will only Retrieve the 
phrases you had saved. 

After you have Saved or Retrieved your music? type 



Oe t 



" S t 


OP 


H 


for 


? 


and you are back in the Main Menu 
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DOS 


DOS stands for Disk Operating System? arid is only used 
when you have a disk drive. Typing ,, D<ret> ,, i for DOS puts 
you in the Atari DOS that was booted when you first turned 
on your system. The standard DOS commands are available? so 
you can examine the directory? and so on. Consult your 
Atari DOS manual for details. 

Should you enter "D<ret>"? and you do not have a disk 
drive? the computer will put you in it's blackboard mode. 

To return to the Music Composer Cartridge? press the "SYSTEM 


RESET" key. 
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r i 
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PART TWO 


A SAMPLE SESSION WITH THE ATARI 


MUSIC COMPOSER CARTRIDGE 




Paste 



ENTERING MUSIC 

In this step-b v-step session? you will enter the music 
for "Row? Row? Row Your Boat". This is a musical round? in 
which the music is repeated by each of the four voices in 
turn? each slightly behind the other. 

With the computer off? insert the Atari Music Composer 
Cartridge. If you are using the Atari-800 computer? use the 
left cartridge slot. Turn on the computer. The program 
should display the Main Menus 

ATARI MUSIC 

Edit music 
Arrange music 
Save 

Retrieve 

DOS 

Listen 

COPYRIGHT ATARI 1979 
WHICH? 

The first phrase of the music you will enter iss 
(music example here) 

Row? row? row your boat / Gently down the stream 
And the second phrase iss 
(music example here) 

Merrily? merrily? merrily? merrily / Life is but a dream. 
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This will be new music? so you will enter the Edit music 
command? and then erase all previous music in the phrase. 
Even though there may not have been any previous music 
entered? it's still a good idea to "clean the slate* 1 ? so 
there won't be any suprises. 

You types EOe t> 

The computer displays the Edit music menu. 

You! POe t> 

The computer asks: PHRASE #? 

You s l<ret> 

C o m p u t e r s E RASE? 

You s Y<ret> 

The computer displays the empty music staves. The 
bottom line of the display asks: SMI? NOTE? 

You: C4Q<ret> 

The computer displays the first note and plays it. It 
is Middle C? a quarter note? or? in terms the computer can 
understand? C of Octave 4? a Quarter note. Now? enter the 
sec o n d note. 

You: CQ<ret> The computer displays and plays both 

notes. They are both alike. You do not have to give the 
Octave number again until you wish to change to another 
octave. The next note? the third note in the first measure 
of the first phrase? is a dotted eighth note. 

Y o u : CE . <1 ret I> 

Notice that each time you enter a note the computer- 
displays and plays all notes in the measure. The next note 
is a sixteenth note. 

You: DSCre t> 
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The next note? the last note of the first measure? is a 
quarter note. But enter it as an eighth note? so you can go 
back and correct your "error". 

You: EECre t> 

Nouj? change the incorrect eighth note. 

You: CTRL < — 

Note that "< — " is pressed while you are holding down 
"CTRL'*. The action of the editing keys is immediate? and 
you don't have to tYPe <ret>. 

The display shows the incorrect eighth note outlined by 
the cursor. Zap the note. 

You: CTRL DELETE 

The measure is displayed and played? minus the zapped 
e i t h t h note. Now enter the co r re c t note. 

You: EQ<ret> 

The entire first measure is played and displayed. Just 
to become more famial iar with the editing keys? try entering 
a note? say a High C half note? between the first two notes 
of the measure. First? move the cursor to Just behind the 
first note. 

You: CTRL < — 

CTRL < — 

CTRL < — 

.) 

CTRL < — 

The cursor should now be in position behind the first 
note. Now you can insert the extra note. 

You : C6H< re t> 

That should give you a High C half note sandwi tched 
between the two Middle C quarter notes. It sounds terrible. 
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Zap it. 

You: CTRL < — 

CTRL DELETE 

Your measure is restored. Now so on to the 2nd measure. 

You: M20et> 

The two music staves are empty again? and the computer 
display says you are in Phrase 1? Measure 2. Notice that 
every time you enter a note? or change measures? the "### 
Free" message displays one number less. It counts down as 
you use up the available computer memory. 

Enter the five notes of the second measure. 

You: E4E.<ret> 

DSCre t> 

EE. <re t> 

FSOe t> 

GH<ret> 

That gets you gently down the stream. Now go back to 
the Main Menu? and Listen to what you've entered so far. 

You s S<ret> 

That puts you back in the Edit music menu. Once again. 

You: SCre t> 

The computer should display the Main Menu. 

You: LOe t> 

That plays your music? and then returns you back to the 
Main Menu. Do it again. 

You: L<ret> 

Not bad. But suppose one of the notes was wrong. A note 
in the 2nd measure of phrase 1? for example. To change the 
note? when you enter "change Phrase"? you DO NOT respond 


Paste 4 


with " YOe t>" to the pr ompt 
out vour entire phrase. 


"ERASE'?" because this would wipe 


You: EOe t> 

The Edit music menu is displayed. You want to charge 
phrase #1* measure #2. 


You: P<ret> 

Computer: PHRASE #'? 


You: l<ret> 

Computer : ERASE? 


You: NO et re- 
compute r: MEASURE #? 

You: 2<ret> 

There you are* back in measure #2. You could change a 
note* if it were real 1 y wrong* by using the edit keys* as 
you did before. Now go back to the Main Menu. 

You: SOe t> 

The Edit music menu is displayed. 

You: SOet> 

And y o u y re in the Ma in me n u • Just for fun* Listen t o 
your music again. 

You: L<ret> 

Now tackle the 2nd phrase. 

You: E<ret> 


POe t> 

Com pu ter: PHRASE #? 

You: 2<ret> 

C omputer: ERASE? 

You: YOet> 

You're back with the music staves* ready to enter more 
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mu sic. 

The first measure of Phrase 2 is a problem. Notice the 
number 3 over each of the groups of three notes in this 
measure. This means they are tripletts. Tripletts are 
three notes p laved in the time it would normal Iv take to 
play two of the notes. The computer won't accept tripletts 
as such? so you need to "fudge " a little. Think of the 
measure as rewritten in its (almost) equivalent forms 

(music example here) 

Now enter these revised twelve notes of the measures 

Y o u s C5S< ret > 

CS. <ret> 

CS • <Iret> 

G4S<re t> 

GS • Oe t> 

GS. <re t> 

ESOe t> 

ES. <ret> 

ES. < ret > 

GS<ret> 

CS* • <ret> 

CS. <ret> 

When the computer played the measure after you entered 
the last note? it did not display the first eleven notes. 

It played all twelve notes but only displayed the last note. 
The screen was full? so it Just tucked them away. If you 

want to see the notes? use the editing key to move the 

. 

cursor back. 


You s 


CTRL < 
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CTRL < — 

The computer displays the first eleven notes of the 
measure. Now* go on to the last measure. 

You 5 M2<ret> 

Enter the five notes. 

You : G4E. <re t> 

FS<re t> 

EE. <ret> 

DSOet> 

CHOe t> 

That does it! Go back to the Main Menu. 

You 2 S<Iret> 

S<ret> 

Now you want to listen to the music you’ve entered. 

You! LOe t> 

The computer played phrase 1 and phrase 2 together. You 
want to hear them played one after another. For this* you 
need to change the Arrange program. 


t 


ARRANGING MUSIC 
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When the computer is first turned on* the Arrange 

program is preset to play phrases 1 to 4 together through 

* 

voices 1 to 4. You want to hear pharase 1* then phrase 2. 

You don't want to hear them together vet. 

First* zap the instruction that plays phrase 2. That's 
the first (and only) instruction in voice 2. 

You s A< re t> 

Computers VOICE #*? 

You s 2<ret> 

Since this is the first time You've entered the Arrange 
music command* the computer displays the Arrange Menu. 

After this* it will only display the Arrange Menu when you 
type ,, M<ret> H . You want to go on. 

You s <s pace bar> 

The computer displays the "Arrange Voice 2" program. 

The only instruction in it is "PLAY PHRASE 2". You want to 
delete that instruction. 

You! CTRL (up arrow) 

This moved the dark colored line pointer — the cursor 
— up to line 1. Now zap the instruction. 

You: CTRL DELETE 

This leaves you with 20 empty program lines. Later* you 
will give voice 2 some new instructions. But for now* go 
back to the Main Menu. 

You s S<ret> 

% 

Listen to the music. 

You s LOe t> 

Only phrase 1 played. You want phrase 2 to play after 
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phrase 1 plays. 

You.' AOe t re- 
compute r 2 VOICE #’? 

You 2 l<ret> 

The computer displays the two steps of the "Arrange 
Voice 1" program. You want to add a 3rd step? to play 
phrase 2. 

You 2 POe t re- 
compute r 2 PHRASE #? 

You 2 2<ret> 

The computer enters "PLAY PHRASE 2" in line 3 of the 
Arrange program. Now? go back to the Main Menu and Listen 
to your music. 

You 2 SO e t> 

LOe t> 

The computer played both phrases? and returned you to 
the Main Menu. Play it again * Sam. 

You 2 LOet> 

That's nice? but this is really supposed to be a musical 
round. Each of the four voices should play one measure 
behind the previous voice. Since the phrases are two 
measures long? you need to enter one more phrase of music! 
a whole note rest. This will allow you to "play" one 

measure of silence. 

You! E<ret> 

POe t> 

Computer! PHRASE #? 

You! 3<ret> 

C o mputer! ERASE? 
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✓ 



You! Y<ret> 

The computer displays the two empty music staves. 

You! RWOe t> 

A whole note rest is displayed. 

You! SOet> 

S<ret> 

You are back in the Main Menu. Phrase 3 now contains 


one measure of silence. Now you are ready to program your 
r o u n d . 

Here is the Arrange program you will enter! 


Voice 1 



Voice 2 


Voice : 



Voice 4 



1 

D i s p 1 ay 


1 

Volume rnp 


1 

Volume mp 


1 

Volume mp 


2 

PI ay 

phrase 

1 

2 

Play phrase 

3 

2 

P 1 ay 

phrase 

3 

2 

P 1 av 

phrase 

o 

3 

PI ay 

phrase 

2 

o 

V 1 

Play phrase 

1 

3 

PI ay 

phrase 

o 

3 

P 1 ay 

phrase 

o 

V . 1 

4 

P 1 ay 

phrase 

1 

4 

Play phrase 

2 

4 

P 1 ay 

phrase 

1 

4 

P 1 av 

phrase 

3 

5 

PI ay 

phrase 

2 

5 

Play phrase 

1 

5 

P 1 ay 

ph rase 

2 

5 

P 1 ay 

phrase 

1 

6 

Play 

phrase 

3 

6 

Play phrase 

2 

6 

P 1 ay 

phrase 

1 

6 

PI ay 

phrase 

2 

7 

Play 

phrase 

3 

7 



7 

PI ay 

phrase 

2 

7 

Play 

phrase 

1 

3 

'7 

PI ay 

phrase 

3 

3 

o 



Q 

O 

o 




o 

o 

o 

P 1 ay 

phrase 

o 


Voi 

ce 1 will 

play the two 

7 

phrases of 

musi c 

twi 

7 

ce . 

At 




reduced volume (default volume is mf ) * the other voices will 
enter 7 each one meter (phrase 3) behind the previous voice. 
After each voice plays the two phrases of music twice? the 
voice is becomes silent. The last voice to play is voice 4? 
which ends up the round by playing alone? Just as voice 1 
started playing alone. Voice 1 is programmed to play phrase 
3 — the whole note rest — Just so you can see it on the 


d i s p 1 av 
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Each voice's arrange program is entered separately. 

Start with voice 1. 

You 5 A<ret> 

Computers VOICE #*? 

You: Kre t> 

The computer displays the 20 program steps. The first 3 
instructions are already entered* so you start with line 4. 

You! P<ret> 

Kre t> 

Notice that each time you enter an instruction* the 
cursor moves down a line. New instructions are always 
entered at the cursor. If you make a mistake* you can use 
CTRL (up arrow) and CTRL (down arrow) to reposition the 
cursor* and reenter the proper instruction. If you do this* 
be sure to use the CTRL (down arrow) to move the cursor to 
the first empty line before continuing. 

The cursor should now be at line 5. Enter the remaining 
program steps for voice 1. 

You 5 P<ret> 

2<ret> 

POe t> 

3< re t> 

P<ret> 

3<ret> 

P<ret> 

3<ret> 

That's it for voice 1. Go back to the Main Menu* and 
Listen . 

You s S< r e t > 
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LOet> 

Go on to voice 2. 

You 2 AOe t re- 
compute r 2 VOICE #? 

You s 2<Iret> 

Enter the six program steps. 

You : V<ret> 

mp<re t> 

POe t> 

3<ret> 

POe t> 
l<ret> 

POe t> 

2<re t> 

POe t> 

1 <re t> 

POe t> 

2<re t> 

Go to the Main Menu? and Listen. 

You 2 SOet> 

L<ret> 

Enter the program for voice 3. 

You 2 AOet> 

C o m p u t e r 2 VO I CE # 7 

You 2 30et> 

The instruction in line 1 savs "PLAY PHRASE 3". You 
want that in line 2? and "VOLUME MP" to be in line 1. For 
this? you move the cursor to line 1 and insert the Volume 


instruction. 
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You! CTRL (up arrow) 

The cursor goes to line 1. 

You: CTRL INSERT 

The instruction in line 1 is moved down to line 2. The 
cursor remains at line li indication this is where the next 
instruction will be entered. 

You: V<ret> 

mp<ret> 

Your ” VOLUME 4" instruction is entered in line 1 * but 
the cursor remains there also. You must move the cursor- 
down to the next empty line* line 3. 

You: CTRL (down arrow) 

CTRL (down arrow) 

That puts the cursor at line 3. Now enter the remaining 
instructions for voice 3. 

You: P<r e t > 

3<re t> 

P<ret> 

l<ret> 

POe t> 

2<ret> 

P<ret> 

1 <1 ret I> 

P<ret> 

2< ret > 

Stop* and Listen. 

You: S<ret> 

L<re t> 

And* on to the fourth and last voice. 
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You s AOet> 

Computers VOICE #? 

You: 4<Iret> 

You don't want instruction 1? "PLAY VOICE 4" » at all. 

So delete it. 

You: CTRL (up arrow) 

CTRL DELETE 

Enter your instructions for voice 4. 

You: V<ret> 

mp<ret> 

P<ret> 

3<re t> 

P<ret> 

3<ret> 

POet> 

30 e t> 

P<ret> 

l<ret> 

P<ret> 

2<re t> 

P<ret> 

Kret> 

POe t> 

2<re t> 

That's it! Stop? and Listen. 

You: S<re t > 

L<ret> 

And Listen again. 

L<ret> 


Y o u : 


You might try expermi n t i ns with 


youp arrange program bv 


c hanging or- inserting volume levels? or by entering 

program steps. But before you do that you'd better 

* 

your music onto your cassette or disk. 


o t h e r 
save 
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SAVING AND RETRIEVING MUSIC 


n o t 
to 


From the Main Menu* the command "S<ret> H means "Save'** 
"Stop% as in the other sub— menus. “Save" allowes you 

store vour music onto vour cassette or disk. "Retrieve 


H 


al 1 owes you to put that music back into the computer memorv. 

When you type n S<ret>"? to Save music* the computer will 
display the "SAVE MUSIC" menu and ask "FN?". It wants a 
standard Atari file name* as "Cs " for cassette* or 
"Ds ROWBOAT" for disk. Refer to Your operater's manuals for 
further details. In this example* we assume you have a 
cassette. You start from the Main Menu. 


You! S< ret > 


The computer displays the Save Music menu. 
Computers FN? 


You! (when console beeps twice* start vour cassette 


re cording) C s O e t> 

Computer s WHICH? 
You s EOet> 
Computer s WHICH? 
You! S<ret> 


AFTER the computer displays the Main Menu* stop vour 
cassette* and rewind it. Your music is saved. The steps to 
Retrieve vour music again are almost the same. 

You s R<ret> 


The computer displays the Retrieve Music menu. This is 
the same as the Save menu* except it savs "RETRIEVE MUSIC" 
on the top line instead of "SAVE MUSIC". Again* the 
computer asks for a file name. 

C o mputer! FN? 


F 'ase 


You 5 (when console beeps once? start 
p 1 av ins) C : < ret > 

Computer : WHICH? 

You! EOe t> 

Computer : WHICH? 

You s S<re t > 

Stop Your cassette after the computer 
Menu. Your music has been entered again 
you are readY to so! 


y our cassette 


displaYs the Main 
into memorY? and 
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PART THREE 


THE MUSIC FILE STRUCTURE 
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GENERAL FILE FORMAT 


r i 
l J 


The purpose of this section of this manual is to allow 
you to write or manipulate music files for the Music 
Composer in BASIC. It is a rather technical section? and 
before attempting it you should already be familiar with the 
Music Composer Cartridge? and with Atari BASIC. 

Files for the Music Composer contain up to three 
different t YPe s of records. The three tYPes of record 
correspond to the Save Music commands to save phrases? to 
save voices? and to save everything. Each of these records 
starts with a header byte? 170? and ends with an end of 
record byte? 255. The last record in the file has an 
additional end of file byte? also 255. 

Records may be in any order. The second byte of each 
record? right after the header byte? identifies which of the 
three record types it is? and thus how the record data bytes 
are to be interpreted. 


A 


'«t ■ 
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PHRASE RECORD 

A phrase record contains pitch and duration values for a 
given phrase. It is the actual program for playing the 
notes in one of the ten Music Composer phrases? and 
corresponds to the Enter Music command. When you Save or 
Restore Phrase x? or All Phrases? you are saving or 
restoring phrase records. Since there are ten possible 
phrase numbers? 0 to 9 ? there can be up to ten defferent 
phrase records. 

Phrase records can be in any order? and can be mixed 
with the other records in any wav. If the computer 


encounters more than one phrase record with the same phrase 
number » the last one read is the one used. 

The phrase record formats 

VALUE I NTERPRETAT I ON 

170 Header bvte 

0-18 Identifier bvte 

0-127 Pitch? Rest? or Measure bvte 

0-255 Duration bvte 

0-127 Pitch? Rest? or Measure bvte 

0—255 Duration bvte 


■ ■ ■ ■ 


• m m m 


0—127 Pitch? Rest? or Measure bvte 

0-255 Duration bvte 

255 End Of Record bvte 

If the identifier bvte is 18 or less? it 


identifies the 


record as a phrase record. 


Divide it bv two for the 


c o r rect 
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phrase number. Thus* an identifier bvte of 18 is phrase 9* 
10 is phrase 5* and 0 is phrase 0. 

The Pitch bvte is a combination of octave* letter name* 
and accidental information. The corresponding values for 
each of these parts of the pitch bvte ares 

Octave Value 

3 0 

4 7 

5 14 

6 21 

Letter name 
C 
D 
E 
F 
G 
A 
B 

Ac c i dental 
Natural 
Sharp 
Flat 

To pack these three seperate value items into a single 
bvte* follow this formulas 

P i t c h =4 ( Le 1 1 e r name value + Octave value) + Accidental 
va 1 ue 

Or* in BASICS 


Val ue 
0 
1 


Val ue 
0 
1 
2 

3 

4 

5 

6 




r i 


L A 
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1 O P I TCH=4* ( NAME+OCTA VE ) + ACC I DENTAL 

Do not attempt to g i ve the computer note values above C 
of Octave 6 (pitch value 84) » or you mar loose data. Rests 
are denoted by a pitch value of 85. This would translate to 
C# of Octave 6» but since the computer can only plav to C of 
Octave 6? there is no conflict. Pitch values of 127 
indicate a measure bar is to be displayed on the screen. 
Pitch values of 128-254 are invalid. 

Valid values for the pitch byte! 

I ntrepretat i on 

pitch from C ? Octave 3 to Ci Octave 6 
rest 

pitch of C b ? Octave 6 
i nval i d 
measure bar 
i nval i d 
end of phrase 

Duration bytes? like pitch bytes? are actually a 
combination of three seperate items of informations 

Note 

Th i r ty— second 

Sixteenth 

Eighth 

Quarter 

Hal f 


Val ue 
0 



4 

6 


o 


Val ue 
0—84 

o=% 

86 

87-126 

127 

1 28-254 


Whole 


10 
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Tie (Legato) 128 

no tie 0 

\ 

Dot 1 

n o d o t 0 


The f o r mu la for t he d u rat i o n byte i s : 

Duration = Note value + Tie + Dot 
Or 7 in BASIC: 

1 0 DURAT I ON=NVALUE+T I E+DOT 

A duration value byte will always follow a pitch value 
byte 7 unless the pitch value byte is 255* end of phrase. If 
the pitch value byte is 127* a measure bar* then a duration 
byte must follow* but it's value is ignored. It’s a s o o d 
idea to make the duration byte value also 127* so it will 
show up better when you examine the file data. 
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VOICE RECORD 



A voice record is the actual program for playing one of 


the four voices. It corresponds to the Arrange music 
command. When you Save or Retrieve Voice x? or All Voices? 
you are saving or retrieving voice records. 

There is one important difference between entering an 
Arrange program with the Music Composer Cartridge? and 
writing a voice record file with BASIC: When you write a 

voice record in BASIC you can have up to 127 program steps 
per voice (although only the first 20 steps — the limit of 
the Arrange voice command — will be displayed). 

Like all the Music Composer records? the voice record 
starts with a header byte? 170? and ends with an end of 



record byte? 255. The identifier byte? directly following 
the header byte identifies the record as a voice record and 


identifies the voice number? 1 to 4. The identifier byte 
for each of the four voices is: 


Val ue 


I ntrepretat i on 


20 


Arrange voice 1 




Arrange voice 2 


24 


Arrange voice 3 


26 


Arrange voice 4 


Following the identifier byte are the command byte and 
the operand byte for each line of the Arrange voice program 
Voice records can be in any order and can be mixed with 
the other records in any way. If the computer enocunters 



more than one voice record for the same voice? the last one 
read is the one used. 
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The voice 

record format s 

Va 1 ue 

I ntrepretat i on 

170 

Header bvte 

20-26 

I dent i f ier bvt 

1 

O 

Command bvte 

0-255 

Operand byte 

0-6 

Command bvte 

0—255 

Operand bvte 


■ ■ • m 


* m 9 m 


0-6 


0 


•“jcrtr 


Command byte 
Operand bvte 


•“icrcr 


End of record bvte 


Note that there are no line numbers as such- The 
computer keeps track of line numbers b v the position of the 
command-operand bvte pair- The first is line 1, the 2nd is 
line 2 ^ and so on. 

Valid command bytes are the numbers 0—6. A command bvte 
value greater than 6 will give unpredictable results? and 
mav lose data- 


Valid command bytes-' 

Val ue I n t re pre tat i on 

0 Null (empty line) 


1 


G o t o 


Play phrase 


3 


Transpose 


Vo 1 ume 


5 


D i s p 1 ay 


6 


Count 


Valid operands are the same as the operands you uiould 


type in with the Arrange voice command* with three 
exceptions. First? you may Goto a line greater than 



UP 


to line number 127. Second? negative 
by adding 128 to the absolute value. 
135. And the third exception is that 
designations 0? pp? p? mp? mf? f? and 


numbers are indicated 
Thus? -1 is 129? -7 is 
the volume 

f f become the numbers 


0 to 7 . 

Also? be warned that the computer checks for errors only 
on input from the Arrange voice command. It does not check 
the data once it is entered in memory. So? invalid commands 
or operands from a BASIC generated voice record will very 


likely cause a system crash 
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MISCELLANEOUS INFORMATION RECORD 

There is only one miscellaneous information record? and 
it's name is longer than it is. This record is used? along 


with voice and phrase records? only with the Save or 


Retrieve Everyth i ng commands 


If the computer ecounters 


more than one miscellaneous information record? the last one 
read is the one used. 

The time signature? the tempo? and the key signature are 
the only information contained in this record. The 
mi see 1 1 aneous i nformat i on format : 


Val ue 
170 
128 
2? 4? 8 
9-2 
0-255 


I n trepretat i on 


Header byte 


Identifier byte 


Bottom number of time signature 


Top number of time signature 


Temp o 


0—7? 128—135 Key signature 

255 End of record 

The first byte after the identifier byte? 128? is the 
bottom number of the time signature. It indicates which 


note gets a beat. This should be 2? 4? or 8? for half? 
quarter? or half notes. Other values will give 
unpredictable results. 

The next byte is the top number of the time signature. 

It indicates the number of beats per measure. Valid numbers 
for this byte are 2 through 9? except for a time signature 
of 8/2 or 9/2. Again? invalid values give unpredictable 
resu 1 t s . 

Any number is valid for the tempo byte. A value of 1 is 
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the fastest tempo possible. 255 is next to the slowest? and 
O is the slowest: almost never. 

The key signature bvte is a value of 0-7 for the number 
of sharps? or a value of 0—7 plus 128 (128—135)? for the 


n u m b e r o f 


flats. 
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A BASIC PROGRAM TO DUMP MUSIC FILES 

This very short BASIC program will enable you to dump 
Music Composer files onto the screen as blocks of numbers. 

It is useful for examining files generated bv the Music 
Composer Cartridge* and for debugging files you have created 
with external programs. 

Since Atari BASIC has different file handeling routines 
for cassette and for disk* the first few lines of the 
program are different for the two types of media. 

If you have a cassettes 

10 REM DUMP MUSIC COMPOSER FILES 
20 REM 

30 REM OPEN CASSETTE FILE 
40 REM 

50 DIM Q* ( 1 ) : 0PEN#3 » 4 » O > " C s " 

And if you have a disks 

10 REM DUMP MUSIC COMPOSER FILES 
20 REM 

22 REM OPEN DISK FILE 
24 REM 

30 DIM FILE*( 14) ,Q*< 1 ) 

40 PRINT "FILE NAME" ? s INPUT FILE* 

» 

50 OPEN #3, 4,0, FILE* 

The remainder of the program is identical for either 




cassette or disk 
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60 REM 

70 REM LOOK FOR RECORD START (170) 

80 IF END BYTE (255) THEN EXIT 
90 REM 

100 GET #3 » BYTE 

110 IF BYTE=255 THEN PRINT "255 (END OF FILE ) " ; : END 
120 IF BYTEO170 THEN 100 
125 PRINT : PRINT BYTE?" " 5 : GET #3, BYTE 
130 REM 

140 REM PRINT RECORD BYTE 
150 REM 

160 IF BYTEC20 THEN PRINT BYTE?" (PHRASE RECORD - PHRASE # " 
BYTE/2; " ) " : GOTO 2 1 0 

170 IF BYTE <27 THEN PRINT BYTE;" (VOICE RECORD - VOICE # "? 

( BYTE-20 ) /2+ 1 ; " ) " : GOTO 210 
180 PRINT BYTE;" (MI SC. INFO. RECORD)" 

190 REM 

200 REM FETCH RECORD DATA 
205 REM 

210 GET #3, BYTE: IF BYTE=255 THEN PRINT BYTE: INPUT Q$sGOTO 100 
220 PRINT BYTE;" " ; GOTO 210 

A sample program run follows. User inputs are 
in square brackets. 

CRUN<ret>3 

FILE NAME? C D : DUMMY . MUS< ret > 3 

170 128 (MISC. INFO. RECORD) 

4401 255?[<ret>3 


sia 
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170 22 (VOICE RECORD - VOICE #2) 
2 O 255?E<ret>3 

170 20 (VOICE RECORD - VOICE #1 > 
5121 255?C<ret>3 


(PHRASE RECORD - PHRASE #1 ) 


11 255?[<ret>3 



The first byte of each record is always 170? the record 
header byte. In the sample run* the second byte found was 128* 
which identifies the record as a Misc. Info, record. The next 
two bytes indicate a time signature of 4/4. Tempo* the next 
byte* is one. Next* the key signature is 0 for 0 sharps* or C 
Major. And the last byte is 255* end of record. 

The second record is identified as a Voice Record for Voice 
#2. There are only two data bytes in the record* 2 and 0. The 
first of these* 2* is the command byte to Play Phrase* and the 
second byte* 0* is the operand byte* Phrase 0. Instructions in 
the four data bytes of the next record* Play Phrase #1* are to 
Display (5) voice #1 (1>» and to Play (2) voice #1 (1). 

Note that the data in the final two records* Phrase record 
#1 and Phrase record #2* start with measure bar bytes* 127 127- 
Phrase records must always start with measure bar bytes* or the 
computer becomes confused on how to display the notes. 

When an end of record byte* 255* is followed by a second 











SAMPLE BASIC COMPOSING PROGRAMS 


These next two programs are examples 
to write Music Composer files in BASIC, 
guidelines only. You can do better. 


of what might be done 
They are intended as 


First? is a fairly short program to write notes randomly? 
but with a few simple rules. 


(program listing here) 


This next program is an adaptation of the Harmony program 
presented by John G. Kemerrr and Thomas Kurtz in thier book 
"Basic Programming" . The program is discussed in detail in this 
book. It's one of the best books on BASIC programming? written 
by the originators of the language. Briefly? the program asks 
for phrase numbers as input. Any number of phrases can be 


given? in any order 


Phrases may also be repeated. When a 


phrase number >9 is given the program stops asking for input and 
starts to calculate the harmony lines. It shifts all the melody 
phrases to the top octave and writes that inot phrase #1? the 
three harmony lines are put into phrase records 2*3 and 4. 

Note that this program? as written? will not work with a 
cassette? as it requires multiple accesses of the same phrase 
record. Also? it only "understands" phrase records. So it's 
input mar not contain Voice records? or Misc. Info, records. 

Once again? this is not an ideal program. It is included here 
to give you an idea of some of the possibilities of writing your 


own Music Composer files in BASIC. Good luck! 


(program listing here) 
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PART FOUR 


QUICK GUIDE TO THE ATARI MUSIC COMPOSER CARTRIDGE 




r i 
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COMMANDS 

Command 
Prompt 2 
Svntax 2 
D i s p 1 a v 
Ac t i on : 

Command 
Prompt 2 
Syntax 2 
D i s p 1 ay 

Act i on 2 

Command 
Prompt 2 
Syntax 2 
D i s p 1 ay 
Ac t i on 2 

Command 
Prompt 2 
Syntax 2 
D i s p 1 ay 
Act i on 2 


FROM THE MAIN MENU 

2 Change music 
WHICH? 

C<ret> 

2 Change Music Menu. 

Allow changes to existing music. 

2 Arrange music 
WHICH? VOICE#? 

AOetX 1— 4)<ret> 

2 Arrange Menu when first called* Arrange Voice 
program thereafter. 

Write or change the program that 
plays music through the four voices. 

2 Save 

WHICH? FN? 

SCretXC! or Ds FILENAME) 

2 Save Music Menu. 

Allow music in memory to be saved 
onto external media (cassette* disk). 

2 Retrieve 
WHICH? FN? 

R< ret > ( C 2 o r D : F I LEN AME ) Cre t > 

2 Retrieve Music Menu. 

Allow mus # ic on external media to be 


put into memory 


Command 2 
Prompt 2 
Syntax! 

D i s p 1 a v 
Action! 

Command 2 
Prompt 2 
Syntax! 
Di spI ay! 
Ac t i on 2 
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DOS 

WHICH? 

DOe t> 

DOS menu. 

Enter DOS . 

Listen 

WHICH? 

L<ret> 

Music staves" notes as programed. 

Plav music through the four voices 


as programmed bv Arrange music. 


COMMANDS FROM EDIT MUSIC 


Commands 
Prompt s 
Syntax! 

D i s p 1 a y s 

Act i on s 

Command s 
Prompt s 
Syntax! 


D i s p 1 a y s 
Ac t i on s 

Commands 
Prompt s 
Syntax s 
D i s p 1 a y s 

Ac t i on s 


Phrase 


WHICH? Phrase #? ERASE? Measure #? 


PO e t > ( 0—9 > < ret > ( Y— N Xret > ( me a s • # X r e t > 


Music staves of measure and phrase 
selected. Music input menu. 

Allow type-in and change of music? as in 
"New music"? but do not erase phrase. 

Meter 

WHICH? METER? 


M<ret> ( beats ) / ( no te ) <ret> 

(beats) = beats per measures 2-9. 

(note) = which note gets a beats 2? 4? 3. 

8/2 and 9/2 are not allowed. 

Meter status changes to new time signature 
Sets time signature. Has no effect 
on how the music is actually played. 


C hi e c k measures 
WHICH? 

COe t> 

Check measures status changes from "OFF" 
to "ON"? or vice-versa. 

When "ON"? and in music input menu? checks 


for the proper number of beats per measure 


Pase 7 


Command s 
Prompt s 
Syntax s 

D i s p 1 a v s 
Ac t i on 5 

Commands 
Prompt s 
Syntax! 

D i s p 1 av s 
Actions 

Command s 
Prompt s 
Svntaxs 
D i s p 1 ay s 
Act ions 


Key S i s - 

WHICH? NEW KEY? 

KCret>(0-7) (S-FXret> 

(0-7) = number of sharps or flats. 

(S-F) = S for Sharps* F for Flats. 

Key status changes to reflect new key. 
Displays music in new key. 

Tempo 

WHICH? NEW TEMPO? 

T<ret>( 1 -9 ) <r e t> 

Tempo status changes to reflect new tempo. 
Changes overall tempo of music. 

S t o p 
WHICH? 

SOe t> 

Ma i n Me n u . 

Exit from Change music menu to Main Menu. 
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COMMANDS 

Command 
Prompt : 
Syntax: 

D i s p 1 a y : 
Act i on : 

Command : 
Prompt : 
Syntax: 


D i s p 1 ay : 
Act i on : 


Command 
Prompt : 
Syntax: 
D i s p 1 ay 
Ac t i o n : 


FROM CHANGE PHRASE 
S top 

SMI, NOTE? 

SOe t> 

Edit menu. 

Exit to Edit menu. 

Measure 
SMI, NOTE? 

MxOe t> 

Note: y x y is next measure number or any 

previously entered measure. If **'x*“ is 
omitted, next measure number is assumed. 
Measure X x*'. 

Move to Measure “ x " , display the measure 
and, if there are any notes in it, play them. 
If "x"' is the current measure number, it 
is replayed. 

Insert measure 
SMI, NOTE? 

I<ret> 

Current measure, but empty of notes. 

Starting with the current measure, move 
all measures up one measure number. Leave 
new current measure empty of notes. 
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Commands enter next NOTE 
Prompts SMI, NOTE? 

Syntax (general example) s 

LETTER (ACCIDENTAL) C OCTAVE 3 DURATION (DOT) (TIE) 
LETTERS C, D, E, F, G, A, B, R (Rest) 

ACCIDENTAL (optional )s S-Shar-p, F-Flat, N-Natural 
OCTAVE Cif ommited, last octave is used] s 1, 2, 3 
DURATIONS W— Who 1 e note 

H— Hal f note 
Q— Q uarter note 
E-Eighth note 
S— S' i x t ee n t h note 
T-Th i r tv— second note 
DOT (optional) s period ( M ." ) 

TIE (optional) s T 
S v n t ax ( e xamp 1 e s ) s 

CS2E.TCret> 

CNQ<re t> 

RWOe t> 

Displays Current measure, with entered note. Cursor- 

moves behind entered note. 

Actions Enter note directly in front of cursor. 


Play measure 


-* 


COMMANDS 

Command : 
Prompt s 
Syntax: 

D i s p 1 a v : 
Ac t i on : 

Command : 
Prompt : 
Syntax: 

D i s p 1 ay : 
Action: 

Command : 
Prompt : 
Syntax: 
Di spI ays 
Action: 


Command : 
Prompt : 
Syntax: 

D i s p 1 a*r : 
Ac t i on : 


TO ARRANGE MUSIC 
Count 

CDGMPSTV? COUNT#? 

C< retXl-127) < ret > 

" COUNT XXX" @ last cursor position. 

Count instruction entered into program. 

The next Goto instruction will loop XXX times. 
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D i s p 1 ay 


CDGMPSTV? 

D<ret> 

M DISPLAY” @ last cursor position. 

Current voice is displayed on screen* 

until another voice si ve s Display instruction. 



G o t o 


CDGMPSTV? L I NE#? 

G< r e 1 1> ( l~20Kret 

” GOTO XX" @ last cursor position. 

Arrange program loops to 1 ine XX. If a 
Count number was previously given* Goto loops 
that many times* then continues to the next 
instruction. If no Count instruction was 
previously given* goto loops continuously. 


Menu 

CDGMPSTV? 

M<ret> 

Arrange Music Menu. 

Displays the Arrange Music menu* 



to decode 
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Command 5 
Prompt : 
Syntax s 
D i s p 1 av : 
Ac t i on : 

Command : 
Prompt : 
Syntax: 

D i s p 1 ay : 
Act ion: 

Command : 
Prompt : 
Syntax: 
Di spI ays 
Actions 

Command s 
Prompt s 
Syntax: 

D i s p 1 ay : 
A c t i *:• n : 


the magic word “CDGMPSTV?" . Type any key 
to return to the Arrange Voice program. 

Play phrase 
CDGMPSTV? PHRASE#? 

PCret > ( 0-9 ) < ret > 

“PLAY PHRASE X" @ last cursor position. 

Plays the phrase throusht the 
current voice. 

S t o p 
WHICH? 

SOe t> 

Main Menu. 

Exit from Arrange voice to Main Menu. 

T ran s pose 

CDGMPSTV? # 1/2 STEPS? 

T <C ret>(- 36 t o 3 6 ) <1 r e t > 

“TRANSPOSE XX “ @ last cursor position. 

All music in current voice is transposed? 
until another Transpose instruction is given. 

Vo 1 u me 

CDGMPSTV? VOLUME? 

VOetXO? ppj p ? mp» mf? f? ff)<ret> 

"VOLUME XX “ @ last cursor position. 

New volume is set for all music in the 
current voice? until another Volume instruction 


is given 


COMMANDS TO SAVE OR RETRIEVE MUSIC 


Command 
Prompt s 
Syntax! 
D i s p 1 a v 
Act ions 

Command 
Prompt s 
Syntax: 
D i s p 1 a v 
Ac t i on s 

Command 
Prompt s 
Syntax! 
Di sp! ay 
Ac t i on s 

Command 
Prompt • 
Syntax." 
D i s p 1 a v 
Action! 


sEE Everyth ins 
WHICH? 

E<ret> 

! Main Menu? after end-of— file. 

All phrases? all voice programs? and the 
Edit music data are Saved/Retrieved. 

s AP A1 1 Phrases 
WHICH? 

APCre t> 

s Main Menu? after end— of— file. 

All Phrases are Saved/Retrieved. 

s AV A1 1 Vo ices 
WHICH? 

AVOe t> 

5 Main Menu? after end— of— file. 

All Arrange Voice programs are 
Saved /Ret r ieved. 

: Px Phrase x 
WH I CH? 

P(0-9Xret> 

! Main Menu? after end— of— file. 

Phrase x (0—9) is Saved/Retrieved. 
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Command 
Prompt 2 
Syntax s 
D i s p 1 a y 
Ac t i on s 

Command 
Prompt 2 
Syntax 2 
D i s p 1 ay 
Actions 


2 Vx Voice x 
WHICH? 

V( l-4>Oet> 

2 Main Menu* after end— of— f i 1 e» 

Arrange voice x (1-4) is Saved/Retrieved. 

s Stop 
WHICH? 

S< ret > 

2 Main Menu. 

Exit from Save/Retrieve to Main Menu- 
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FILE FORMATS 


Mi seel laneous information format: 


Va 1 ue 
170 
128 


I n trepre tat i on 
Header bvte 


Identifier bvte 


2*4*8 Bottom number of time signature 

9—2 Top number of time signature 

0—255 Tempo 

0—7 7 128—135 Key signature 


255 End of record 


Phrase Record Format: 


VALUE 

170 

0-18 

0-127 

0-255 

0-127 

0-255 

• • m m 
m m m m 

0-127 

0-255 


INTERPRETATION 

Header bvte 

Identifier bvte 

Pitch* Rest 7 or Measure bvte 

Durat i on bvte 

Pitch* Rest* or Measure bvte 
Durat i on bvte 

• ■ m m 
m 9 m m 

Pitch* Rest* or Measure bvte 

Duration bvte 

End of record bvte 
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The Voice Record Formats 


Val ue 

I nt repre tat i on 

170 

Header bvte 

20-26 

Identifier bvte 

0-6 

Command bvte 

0-255 

Operand bvte 

0-6 

Command bvte 

0-255 

Operand bvte 


■ ■ ■ ■ m » m m 


0-6 


Command bvte 


0-255 Operand bvte 

255 End of record bvte 



